15장. 터미널 최소한

이 장의 목표 Ollama·MLX·llama.cpp 같은 도구를 쓸 때 더는 터미널이 무섭지 않게 됩니다.

명령어 20개만 익히면 됩니다.

15.1 터미널이 뭔가

맥을 글자로 조작하는 창입니다.

Finder (마우스로 클릭)  ↔  터미널 (글자로 명령)

같은 일을 하는 두 방식 중 하나입니다.

로컬 AI 도구의 80%는 처음 한두 번은 터미널을 거쳐야 합니다.

15.2 터미널 여는 법

방법 두 가지.

1. Spotlight 검색
   • Cmd + Space → “terminal” 입력 → Return
2. Launchpad → 기타 → 터미널

요즘은 더 예쁘고 빠른 Warp, iTerm2, 또는 macOS 기본 터미널의 후속 Ghostty도 인기.

이 책에서는 기본 Terminal.app 또는 zsh 기준으로 설명합니다.

처음 열면 이런 게 떠 있습니다.

kjj@MacBookPro ~ %

코드 블록에서는 $ 또는 % 로 시작하는 줄이 명령이고, 나머지는 출력입니다. 실제 입력 시 $ / % 는 빼고 칩니다.

15.3 첫 5개 명령어 — 위치와 파일

pwd — 지금 어디?

$ pwd
/Users/kjj

ls — 여기 뭐 있어?

$ ls
Applications  Desktop  Documents  Downloads ...

자주 쓰는 옵션:

$ ls -lh        # 자세히 + 사람이 읽기 쉬운 크기
$ ls -lha       # 숨김 파일까지

cd — 이동

$ cd Documents
$ cd ~/Downloads   # 홈 기준 절대 경로
$ cd ..            # 한 단계 위로
$ cd -             # 직전 위치로

mkdir — 폴더 만들기

$ mkdir local-ai

open — Finder로 열기

$ open .       # 현재 위치를 Finder에서 열기
$ open ~/.ollama   # Ollama 폴더 열기

15.4 두 번째 5개 — 파일 보기·찾기

cat — 파일 내용 보기

$ cat README.md

less — 길면 한 페이지씩

$ less very-long.log
# q 누르면 종료

head / tail — 앞·뒤만

$ head -n 20 server.log
$ tail -n 50 server.log
$ tail -f server.log    # 실시간 새 로그

grep — 글자 검색

$ grep "ERROR" server.log
$ grep -r "TODO" ~/Code  # 폴더 안 전부

which — 이 명령어 어디 있어?

$ which python3
/opt/homebrew/bin/python3

15.5 세 번째 5개 — 시스템 상태

top / htop

지금 무슨 프로세스가 도는가.

$ top
# q 누르면 종료

htop 은 더 보기 좋음 (brew install htop 필요).

df -h — 디스크 남은 용량

$ df -h
Filesystem    Size   Used  Avail  Capacity
/dev/disk1   500Gi  120Gi  380Gi    25%

du -sh — 폴더 크기

$ du -sh ~/.ollama/models
84G   /Users/kjj/.ollama/models

free 또는 vm_stat — 메모리

macOS에는 free 가 없습니다. 활성 상태 보기 앱을 쓰는 게 편하지만 터미널로 확인하려면:

$ vm_stat

또는 더 쉽게:

$ top -l 1 | grep PhysMem
PhysMem: 38G used (5G wired), 26G unused.

kill — 프로세스 종료

$ kill -9 12345     # PID 12345인 프로세스 강제 종료

PID는 top 이나 ps aux 로 확인.

15.6 네 번째 5개 — 다운로드·네트워크

curl — URL에서 데이터 가져오기

$ curl https://example.com

옵션:

$ curl -O https://example.com/file.gguf   # 파일로 저장
$ curl -L ...                              # 리다이렉트 따라가기
$ curl -s ...                              # 진행 표시 숨김

wget — 또 다른 다운로드 도구

기본 macOS에는 없음. 설치:

$ brew install wget

ping

$ ping google.com

ifconfig 또는 ipconfig getifaddr en0 — 내 IP

$ ipconfig getifaddr en0
192.168.0.42

lsof -i :PORT — 이 포트 누가 쓰고 있어?

$ lsof -i :11434
COMMAND   PID  USER ...
ollama    1234 kjj  ...

15.7 Homebrew 설치 — 맥의 패키지 매니저

로컬 AI 도구를 받을 때 거의 항상 거치는 길.

$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

한 번 설치하면 다음처럼 씁니다.

$ brew install wget
$ brew install htop
$ brew install ollama        # 이렇게도 받을 수 있지만 GUI 앱 권장
$ brew upgrade               # 전체 업데이트
$ brew list                  # 깔린 것 보기
$ brew uninstall wget        # 삭제

15.8 Python 환경 — 가상환경

MLX 같은 Python 도구를 쓸 때 시스템 Python을 더럽히지 않기 위해 가상환경을 씁니다.

$ mkdir ~/Developer/local-ai
$ cd ~/Developer/local-ai

$ python3 -m venv .venv      # 가상환경 생성
$ source .venv/bin/activate  # 진입
(.venv) $ pip install mlx-lm

(.venv) $ deactivate         # 나가기

가상환경에 들어가면 프롬프트 앞에 (.venv) 가 표시됩니다.

15.9 환경변수와 PATH

처음에는 몰라도 되지만, 도구 설치 후 “command not found” 가 뜨면 PATH 문제입니다.

$ echo $PATH
/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:...

zsh 설정 파일은 ~/.zshrc.

$ open ~/.zshrc

자주 추가하는 줄:

export PATH="/opt/homebrew/bin:$PATH"

수정 후:

$ source ~/.zshrc    # 변경 즉시 적용

15.10 알아두면 편한 zsh 단축키

15.11 모르겠으면 --help 또는 man

거의 모든 명령어에 도움말이 있습니다.

$ curl --help
$ man curl       # q 로 종료

이 장에서 기억할 한 가지

이 책에서 자주 쓸 명령은 결국 10개입니다.

pwd ls cd mkdir open cat tail grep curl top

나머지는 필요할 때 검색하면 됩니다.

손으로 해볼 것

1. 로컬 AI 작업 폴더 만들기

$ mkdir -p ~/Developer/local-ai
$ cd ~/Developer/local-ai
$ pwd
$ open .

이 폴더가 앞으로 모든 실습의 베이스가 됩니다.

2. Homebrew 설치 확인

$ which brew

경로가 나오면 OK. “not found” 가 나오면 15.7 절을 참고해 설치하세요.

3. 디스크·메모리 상태 점검

$ df -h
$ top -l 1 | grep PhysMem

내 맥에 모델 받을 여유가 얼마나 있는지 확인.

다음 장에서는 LM Studio — 가장 친절한 로컬 AI GUI 도구로 첫 모델을 받고 돌려봅니다.

설치부터 첫 질문까지 15분이면 됩니다.